home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Floppyshop 2
/
Floppyshop - 2.zip
/
Floppyshop - 2.iso
/
_catalog.s
/
stcat.103
/
rdd.txt
< prev
next >
Wrap
Text File
|
1997-04-01
|
28KB
|
553 lines
The Revenge Document Displayer
Copyright (c)1990,91,92,93,94 Stuart Coates
Version 3.20
26th March 1994
*****************************************************************
NOTE: Magazine editors, if you're thinking about including the
RDD on a cover disk then read on for distribution conditions.
Failure to do so may prove to be very costly!
*****************************************************************
Welcome to the Revenge Document Displayer v3 (RDD3) undeniably
the fastest document viewer on the ST/TT/Falcon! The objective
with the release of RDD3 is to provide a text viewing utility for
the Atari ST/TT/Falcon range of micros that is powerful and easy
to use. Previous versions of RDD had a vast number of options
available to the user, RDD3 has omitted some of the less used
features of previous releases but has gained several very
powerful ones.
A Brief History
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The RDD v1.00 was released on 15th April 1990 in response to a
request from a friend of mine for a text viewing utility that was
more flexible than the GEM Desktop's own. RDD1.00 was written in
Hisoft Basic and didn't contain many features. I decided to
develop the idea of the RDD from this base with several releases
throughout the year resulting in RDD 1.93 released on 28th
October 1990. That Xmas I purchased Lattice C v5.00 and decided
to learn C - no better way than to port RDD to C.
RDD v2.00 was released on 3rd February 1991 and contained many
more features and was a lot faster. RDD2 was a lot more stable
than RDD1 because of this rewrite. During 1991 and 1992 no less
than 21 versions were released and 14 organisations purchased
custom copies. Several other text viewers sprang up during this
time which I'm grateful for as they gave me new ideas for the
RDD, this also gave the ST community greater choice. Version
2.30 was released on 27th September 1992 and was the last RDD2
release.
I received a large amount of feedback from RDD2 which encouraged
me to start work on RDD3 in December 1992. The first beta
release was shipped to testers in January 1993. Very few bugs
were found in this although many features were missing. The RDD3
that you see today has taken many months to develop and has been
thoroughly tested.
Using The RDD3
¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Loading a document:
There are several way to load documents into the RDD3,
1. Double click on RDD.PRG from the desktop and use the GEM file
selector to pick a document.
2. Rename RDD.PRG to RDD.TTP and enter a document name on the
command line when running.
3. Install RDD.PRG as an application on the desktop so that it
is loaded every time that you click on a text file.
4. If you have TOS2 installed or one of the many replacement
desktops that allow you to place items on the desktop then place
the RDD3 on the desktop and you can simply drag documents to it.
(I strongly recommend Terradesk for this).
5. Machines running Neodesk 3 can have the RDD installed as the
default text viewer so that any docs are displayed using the
RDD3.
6. (For programmers only..) Launch the RDD from your own shell
using the GEMDOS Pexec function. On the command line you should
pass a list of documents that you wish to load separated by
spaces. The RDD3 supports the ARGV protocol for extended command
lines.
Loading Multiple Documents:
The RDD3 has support for multiple documents in memory, in fact
currently up to 200 docs can be resident at once, this is of
course dependent on available memory. To load more than one doc
you can either specify individual filenames or use wildcard
matches, for example if you wanted to load all .TXT files then
tell the RDD3 to load *.TXT. The RDD3 also understands folder
structures, so to load all of the documents within a folder just
specify the folder name. The RDD3 does not scan folders
recursively.
Compressed Documents
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
RDD3 supports documents that have been compressed using Pack-Ice
2.40, this allows you to have an archive of compressed documents
that don't eat up huge amounts of disk space.
Archive Files
¯¯¯¯¯¯¯¯¯¯¯¯¯
RDD3 can recognise most popular archive formats and has the
ability to perform a verbose listing of the archive contents.
The current release of RDD supports ZIP,ARC,ZOO,ARJ,LZH files.
To make use of this feature simply load the archive file, to
bypass the automatic listing feature hold down the Alternate key
while loading the archive.
Pictures
¯¯¯¯¯¯¯¯
RDD3 has very limited support for Degas PI? picture files and
will only display pictures that are compatible with the current
screen resolution - normally ST resolutions only. When a picture
is loaded a document will be created with the line: 'PICFILE:
<filename>', press Alt-V to view this picture.
Document Formatting
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Before a document can be displayed by the RDD3 it must be
formatted, this is done whenever a doc is loaded. Formatting
causes any long lines within that doc to be wrapped to fit on the
screen and tab characters to be expanded. Lines can be either
wrapped at the edge of the screen or at the end of the line (up
to 512 characters) - this option is configurable within the RDD.
On-Line Help
¯¯¯¯¯¯¯¯¯¯¯¯
The RDD3 has built in help that gives you a list of keyboard
controls, to gain access to this press HELP while you are viewing
a document.
Main Features
¯¯¯¯¯¯¯¯¯¯¯¯¯
I'm not going to go through every feature in the RDD3 in great
detail as that would take far too long and you probably wouldn't
want to read it anyway, so I'll just list the main features and
give a small explanation for each.
Scrolling: Probably the most important feature, to scroll up and
down use the arrow keys or move the mouse up and down. You can
also move a screen at a time by holding down either shift key
while scrolling. If the current document has lines that are
longer than than the screen width and they haven't been
automatically wrapped then pressing the left/right arrow keys
will scroll the whole screen left/right. Pressing Shift-
Left/Right will cause the screen to move to the start/end of the
longest line.
Move to Top or Bottom of Doc: Press Alt-T to go to the top or
Alt-B to go to the bottom
Goto a line: To go to a particular line press Alt-G and enter the
line number that you want to go to.
Find a word: Press Alt-F to search for a piece of text. You can
also set up case-sensitive and global searches using this option.
Pressing Alt-N and Alt-P allow you to find the Next or Previous
occurrence.
Load a document: To load another document press Alt-L or click
the right mouse button, you will then be presented with a file
selector, select the file that you wish to load and the RDD will
do the rest. The contents of the Atari clipboard can be loaded
by pressing Ctrl-A.
Close a document: When you've finished with a document hit Alt-C
to close it. All documents will be automatically closed when the
RDD terminates.
Switching Documents: If you've got several documents loaded then
you can switch between them in several ways:
Keypad - Move to previous document
Keypad + Move to next document
Tab Show list of loaded documents
F1-10 Move to document 1-10
Shift F1-F10 Move to document 11-20
Changing tab width: Press Ctrl-T to change the tab setting for
the current document. Tab settings are stored on a per document
basis.
Printing a Document: Press Ctrl-P to print the current document
and Ctrl-C to configure the printer. Ctrl-W will let you print a
marked block.
Marking a block: Alt-S and Alt-E allow you to start and end a
block, pressing Alt-H will hide any block. The start and end of
the block may be changed on a line-by-line basis by pressing
Control+Up/Down to alter the start and Control+Shift+Up/Down to
alter the end. A block can be saved to disk by pressing Alt-W,
or to the Atari clipboard by pressing Alt A.
Locate RDD: Pressing Ctrl-L will allow you to locate the RDD.PRG
file to allow a configuration file to be saved in the correct
directory. Press Ctrl-L and the file selector will appear, find
the RDD.PRG file and select it. The RDD.PRG file will now be
loaded and its location encoded within it.
Save settings: The configuration can be saved by pressing Ctrl-S.
Before using this option for the first time you must run the
'Locate RDD' option.
Bookmarks: You can store the current position in a document by
setting a bookmark. RDD3 supports 100 bookmarks. You can set
the first 26 bookmarks simply by pressing Shift and any letter A-
Z. You can return to a stored bookmark by hitting just the
letter A-Z. You can set all 100 bookmarks by pressing Ctrl-B.
Bookmarks can be accessed easily by pressing Alt-M. Bookmarks
can be saved on a per document basis into a .BMK file that is
automatically loaded next time the document is loaded. Press
Ctrl-Z to save the bookmarks and Alt-Z to reload.
ST/IBM Characters: RDD3 supports both ST and IBM character sets,
you can toggle between them by pressing Escape.
Feature menu: RDD3 features a menu that you can perform
operations from without using any strange key combinations. This
menu can be accessed by clicking the left mouse button or
pressing Insert.
Toggle Text Size: To switch between the two available font sizes
press Ctrl-G.
50/60Hz: On some screens you can toggle between 50/60Hz refresh
rates by pressing Keypad *, not all monitors/machines support
this feature.
Locate external editor: The RDD has the ability of support an
external editor program to manipulate documents. To tell the RDD
the location of this program press Ctrl-D.
Execute external editor: To load the current document into an
external editor press Alt-D. The current document will be re-
loaded after editing.
Document Information: To obtain statistics on the current
document press Clr Home.
View Picture: If a line with the structure 'PICFILE: <filename>'
is at the top of the screen, pressing Alt-V will display it.
Sorting Documents: If you have many documents loaded into the
RDD you can sort them into alphabetical by pressing Alt-O. Using
this option will result in all bookmarks being cleared.
Running External Programs: The run an external program press
Alt-X and select the program that you require. If the current
document is an executable file then you can press Ctrl-X to run
it.
Utilities: The RDD has the ability to store up to 20 external
utilities that are accessible with a single keystroke. These
programs can be set up two ways. Press Ctrl-U or Ctrl-0 to 9 to
locate a utility. A utility can be accessed by either picking it
from a menu by pressing Alt-U or by pressing the appropriate
number key, 0 to 9.
Mouse Control: The mouse plays an important role in the use of
the RDD. You can scroll through documents by moving the mouse up
and down and call up the feature menu by pressing the left mouse
button. The mouse can also be used within menus to make
selections. In fact, although the RDD is a text based program,
all of its features can be accessed via the mouse.
Getting Help: If you require help while using the RDD press
the Help key for a list of available help topics.
Toggle Line Wrap: The RDD can handle documents with long lines
in two ways: Firstly, it can wrap all lines at the end on the
screen causing the remainder of the text to appear on the next
line. Secondly, lines can be kept intact and the RDD can scroll
sideways to view all text. Press Alt-R to toggle this feature.
When sideways scrolling is enabled the RDD will suffer a slight
slow down, so if fast scrolling is important leave line wrap
switched on.
Hex Dump: You can obtain a hex dump of a file in two ways, upon
loading if you hold down the Alternate key, or once loaded by
pressing Ctrl-H. If you chose to hex dump a file that is already
loaded, the original file will be re-read and a separate document
will be created.
Exiting: To exit from the RDD press the UNDO key twice.
Compatibility
¯¯¯¯¯¯¯¯¯¯¯¯¯
The RDD3 was written on a 16MHz Atari 520STe with 4MB of RAM and
TOS 1.62 (UK version)/TOS 2.06 (US version), therefore it should
be 100% compatible with a similar platform. The beta testers of
the RDD3 have varying configurations ranging from a 1040STFM up
to a 16MB Falcon030 and have not reported any problems in the
many months of testing. The code for the RDD3 does not make any
illegal calls and does not rely on any special hardware being
present (blitter, hardware scrolling, etc...) so should work on
most configurations. With the release of version 3.10 support
has been added for non-ST screen resolutions including those on
the TT and Falcon - previous versions would only work in an ST
resolution.
The RDD3 should not conflict with any other programs that are
running on your machine as it only accesses memory that it
allocates itself. The RDD3 has not been tested under MultiTOS
and is not expected to fully work - if this becomes an issue then
a MultiTOS compatible version will be produced.
If you do experience some problems with the RDD3 then please
report them - I cannot fix them if I don't know about them!, see
the 'Support' section later in this document for details of how
to do so.
System Requirements
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The RDD3 will run on anything from a 520ST upwards. If you plan
to make extensive use of the multi-document features then you'll
be needing plenty of memory - the RDD3 can make use of all of
your memory - not just ST-RAM. To gain extra speed from a basic
ST the RDD3 uses highly optimized text routines for all of it's
text output and scrolling. If you have a screen accelerator
loaded such as Warp 9, NVDI, QuickST, or TurboST, you will not
notice any speed change at all while using the RDD3 as my
routines are faster and completely bypass the TOS routines. The
RDD3 will only run on screens that support a resolution of
640x200 or higher.
Special 68030 version
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The RDD3 is now available optimized for the 68030 processor.
This provides a huge speed improvement on machines using this
processor (TT/Falcon). RDD030.PRG will NOT work on machines that
have a processor less than a 68020, and should not be tried - it
WILL crash your machine. The 68881/68882 co-processors are also
supported in this version but are not required. If you require
the RDD to work on all machines then use RDD.PRG not RDD030.PRG.
RDD3 Program Details
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Design and Coding Stuart Coates
Install Program Mark Matts
Beta testers Mark Matts
Keith Frisby
Trev Ward
Gordon Meyer
John Charles
Robert Darling
Stuart Richards
Daron Brewood
Don Williams
Development Tools Lattice C v5.60
Devpac 3.10
Harlekin 2/3
Development Hardware Atari 520STe
16MHz Accelerator
4MB Ram
48MB Seagate 157N
Atari SM124
ZyXEL U-1496E+
Useful Reference Manuals Atari ST Internals
- Abacus
The Atari Compendium
- SDS Publishing
M68000 Programmer's Reference Manual
- Motorola Semiconductors
Programming the 68000
- Sybex
Support
¯¯¯¯¯¯¯
The RDD3 is a complex program and therefore may contain some
bugs. I would be very grateful if you could report any bugs that
you find direct to myself via email (addresses below) or if you
don't have email access then via my support BBS sysop Mark Matts
at the address below. The RDD3 has a built-in debug feature that
assists in the debugging process. When you load the RDD3 if you
hold down the Control key a file called RDD.DBG will be created -
please send a copy of this file along with your bug report.
Mark Matts
66 Telford Way
Leicester LE5 2LX
England U.K.
My email addresses:
(preferred) Internet : scoates@filesys.demon.co.uk
scoates@eurobase.demon.co.uk
Compuserve : 100010,2106
NeST : 90:100/304
Atarinet : 51:6/204
Official support BBS:
System ST BBS
Inside UK : 0533 413443
International : +44 533 413443
Times : 2200-0700 GMT
Speeds : 300-14400
NeST : 90:100/300
Atarinet : 51:6/200
The very latest version of RDD can always be downloaded from
System ST first, and from Compuserve within a couple of days of
release in the ATARIPRO forum.
Registration
¯¯¯¯¯¯¯¯¯¯¯¯
The RDD is distributed as shareware which means that if you use
it then you're expected to register. The registration fee is 5
pounds sterling (or US$10) and should be sent to my support BBS
sysop, Mark Matts (his address is mentioned earlier in this doc).
All registered users will receive a copy of the latest version.
The latest version of the RDD will also be made available via
various BBS's and on-line systems. If you don't have access to a
modem then you can obtain a copy of the latest version by sending
5 pounds sterling (or US$10) to Mark Matts.
The RDD may be distributed freely by any PD Library or BBS but
MAY NOT be used on any magazine cover disk without permission
from the author, any magazine failing to comply with these
restrictions will have action taken against them. Disk only
magazines are free to use the RDD without the authors permission
on the condition that a copy of the relevant edition is sent to
Mark Matts in advance of publication.
Special Versions
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
In the past the RDD has been available in customized versions,
version 3 is no different. Built in to the RDD3 is an ability to
display a screen of text when loaded. This could be useful for
PD Libraries who use the RDD on catalogue disks. If you want to
obtain a customizing program for the RDD then send 10 pounds
(sterling) or $20 US to Mark Matts stating that you require the
customizing utility. In return you will receive the latest
version of the RDD and the customizing utility. Unlike earlier
versions of the RDD, this will allow you to change the
customizations yourself instead of sending files to the author.
Why no direct support?
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
I'm not publishing my postal address as it is currently changing
every few months and this would result in some correspondence
being lost. Mark Matts has offered to handle all registrations
and correspondence on my behalf and will forward any bug reports
direct to myself. I do have several email addresses available if
you do require to contact me.
Thanks go to:
¯¯¯¯¯¯¯¯¯¯¯¯¯
Mark Matts
- for handling subscriptions, having the
occasional good idea, and for writing the
installation program.
Daron Brewood
- Falcon030 testing
All of the Beta Testers
- Thanks for the bugs guys!
Atari ST Review
- Excellent review of v3.00 (Jan94)
HiSoft
- Great Dev Tools
All those who have registered.
Future plans for RDD:
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
The RDD is undergoing continual development, some of the features
that are likely to be included in future releases are listed
below:
Sound prompts for actions performed within the RDD. For example
the RDD could play a sample whenever a file is loaded.
Support for MultiTOS / Geneva / Mag!X - background printing and
document formatting.
Full support for the Falcon 030/040 including the DSP - just
imagine the scrolling speed that this would be capable of - need
to get my hands on a Falcon!
Revision History:
¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
Version 3.00 - 23 October 1993
Complete re-write.
Version 3.10 - 29 January 1994
Support for higher resolution screens - Overscan/TT/Falcon.
- complete re-write of text/scrolling routines
resulting in a 5% speed up in screen output.
Sideways scrolling for documents with long lines.
Screen colour toggle.
Small amount of redundant code removed.
Numerous bug fixes.
Version 3.20 - 26 March 1994
Bug with global searches fixed.
- introduced at v3.00
Bug with bookmarks when in widescreen mode fixed.
- introduced at v3.10
Bug with incorrect screen resolution detection fixed.
- introduced at v3.00
Bug when loading over 28 composite documents fixed.
- introduced at v3.00
Bugs in IBM box characters fixed.
- introduced at v3.00
Bug with corrupt .LZH files crashing fixed.
- introduced at v3.00
Bug with incorrect clipboard detection fixed.
- introduced at v3.00
Better handling of colours.
Built in debug feature.
Adjustable block positioning.
100 bookmarks available.
Save / Load bookmarks.
Optimized version for 68030 machines.
Keyboard controls help screen modified.
Hex Dump Feature.
Customized versions available.
More redundant code removed.
Greater stability with large amounts of docs.